Sets the size and position of a window in its user state.

OSStatus SetWindowIdealUserState (
    WindowRef window, 
    Rect *userState
);

window

A pointer to the window for which you wish to set the user state.

userState

Set this rectangle to specify the new size and position of the window’s user state, in global coordinates.

function result

A result code.

DISCUSSION

Because the window definition function relies upon the WStateData structure, it is unaware of the ideal standard state, and this causes the user state data that it stores in the WStateData structure to be unreliable. While the Window Manager is reliably aware of the window’s zoom state, it cannot record the current user state in the WStateData structure, because the window definition function can overwrite that data. Therefore, the function SetWindowIdealUserState maintains the window’s user state independently of the WStateData structure. The SetWindowIdealUserState function gives your application access to the user state data maintained by ZoomWindowIdeal. However, your application does not typically need to use this function; it is supplied for completeness.

See also the function GetWindowIdealUserState.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when WindowsLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by WindowsLib 8.5 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)